home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / comm / zsview.zip / ZSVIEW.DOC < prev    next >
Text File  |  1996-05-07  |  20KB  |  601 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                  
  18.  
  19.  
  20.                  ZSView - A viewer for ALLFILE.DIR
  21.                            
  22.                            
  23.                            
  24.                            
  25.                            
  26.                            
  27.                            
  28.                            
  29.                            
  30.                            
  31.                            
  32.                            
  33.                            
  34.                            
  35.                            
  36.                            
  37.                            
  38.                            
  39.                            
  40.                            
  41.                            
  42.                            
  43.                            
  44.                            
  45.                            
  46.                            
  47.                            
  48.                            
  49.                            
  50.                            
  51.                            
  52.                            
  53.                            
  54.                            
  55.                            
  56.                            
  57.                            
  58.                            (C) 1996   End Users, Inc.
  59.  
  60.                                                                           
  61.  
  62.  
  63.                            Table of Contents
  64.  
  65.      Overview.................................................... 2
  66.      Before you begin............................................ 3
  67.      ZSView...................................................... 4
  68.      Usage....................................................... 4
  69.      Main Index.................................................. 4
  70.      File Viewing................................................ 5
  71.      Sort Menu................................................... 6
  72.      Save........................................................ 6
  73.      Files Needed / Files Deleted................................ 7
  74.      Error Messages.............................................. 8
  75.      Additional Notes............................................ 9
  76.      Speed....................................................... 9
  77.      Disclaimer.................................................. 9  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                    - 1 -                         ZSView.DOC
  121.  
  122.  
  123.      Overview:   
  124.          
  125.          ZSView is a dedicated viewer for the file listings contained in
  126.      ALLFILE.DIR.  ZSView will also handle the individual directories in
  127.      ALLFILES.ZIP as a whole, as if they were all contained in ALLFILE.DIR,
  128.      creating an index for all 97 directories.  ZSView will handle any 
  129.      individual directory up to about 2 Meg.
  130.          
  131.          ZSView can also sort the file listings in a directory by Name,
  132.      Date or Size.  And ZSView can handle the multiline file descriptions 
  133.      up to 50 lines per listing.
  134.  
  135.          ZSView is written in QB 4.0, so it will run on an XT (although 
  136.      the sorting routines may be quite slooow on large directories).
  137.          
  138.          Also included in the package is PRETREAT.  This program is 
  139.      run once before using either ZSView or ZS.  PRETREAT corrects
  140.      problems in ALLFILE.DIR or the file directories which would cause
  141.      trouble for the search and sort routines in ZSView or ZS.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                    - 2 -                         ZSView.DOC
  181.  
  182.  
  183.      Before you begin:
  184.          If this is the first time you are running ZSView (or ZS)
  185.      then you must run PRETREAT.EXE before you run ZSView (or ZS).
  186.          PRETREAT corrects three problems in ALLFILE.DIR or the 
  187.      file directories, hence it has three options:
  188.  
  189.              PRETREAT   T X F
  190.  
  191.              Options:  T -  Tabs are converted to 7 spaces. (Although in
  192.                             the latest ALLFILE.DIR {4-2-96} there were
  193.                             no tabs used.)
  194.  
  195.                        X -  Useless lines with "@X80" contaminating the 
  196.                             filename area are removed.
  197.  
  198.                        F -  That portion of the DIR98 listing in 
  199.                             ALLFILE.DIR (between the two 
  200.                             =================== lines) which doesn't obey
  201.                             the rule whereby multiline descriptions are 
  202.                             marked off with a vertical bar, "|", is
  203.                             changed to comply.  (This is not necessary 
  204.                             for the files in ALLFILES.ZIP -- no DIR98!.)
  205.                             The few blank lines left and the two 
  206.                             =================== lines cause an 
  207.                             inconsequential problem when the file is 
  208.                             sorted:  they all appear at the top or bottom
  209.                             depending upon the type of sort done.
  210.  
  211.          The options for PRETREAT may be run together or individually
  212.      as circumstances dictate.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                    - 3 -                         ZSView.DOC
  241.  
  242.  
  243.      ZSView:
  244.         
  245.          ZSView is written in QB 4.0 and runs in glorious 16 color 80 x 25 
  246.      text mode.  ZS can be either in the directory with the files being 
  247.      searched or on the path.
  248.  
  249.         
  250.         
  251.         
  252.      Usage:                         
  253.      
  254.          ZSView 
  255.      
  256.      That's it!  No options are needed or taken.  ZSView will scan the 
  257.      current directory to determine which set of directories is being 
  258.      viewed.  ZSView first looks for a file called ALLFILE.DIR.  When 
  259.      that's found, ZSView then looks for the associated index file, 
  260.      ALLFILE.IDX.  If this is the first time you're running ZSView (or if
  261.      you've had to delete the index previously) then an index file will 
  262.      be created.  Once that's done without error, you'll be placed into 
  263.      the Main Index, the table of contents for ALLFILE.DIR.
  264.          If the hard drive directory you're in doesn't contain ALLFILE.DIR,
  265.      then ZSView will look for a file called DIR01.  If found, ZSView
  266.      assumes you are viewing the individual directories and then looks for
  267.      the associated index file ALLFILES.IDX.  If the index file isn't
  268.      found, ZSView will create it and then launch you into the Main Index.
  269.          If neither ALLFILE.DIR or DIR01 is found, you will be dumped back
  270.      to the DOS prompt with an error message about not being able to find
  271.      any files to view.  If you were trying to view the individual 
  272.      directories contained in ALLFILES.ZIP and were simply missing DIR01, 
  273.      then after you restore DIR01 you should delete ALLFILES.IDX and rerun
  274.      ZSView to recreate a new index.
  275.  
  276.  
  277.  
  278.  
  279.      Main Index:
  280.  
  281.           When ZSView begins (assuming the IDX file exists) it will place
  282.      you into the Main Index.  This is a table of contents for the
  283.      directories contained in ALLFILE.DIR or the individual directories
  284.      originally packed in ALLFILES.ZIP.
  285.  
  286.          A reverse video highlight bar will tell you which directory is
  287.      currently under consideration.  Hitting "Enter" will allow you to 
  288.      view the contents of that directory.
  289.          For other directories use the cursor keys to move about the Index.
  290.      You may call up a help menu for that by hitting "F1."
  291.  
  292.          If you find a blank line nestled between two directory names,
  293.      this indicates a faulty ALLFILE.DIR or a missing directory, DIR##,
  294.      in the hard drive directory where you unzipped ALLFILES.ZIP.  Should
  295.      you retrieve the missing directory or find an unblemished copy of
  296.      ALLFILE.DIR, delete the IDX file and let ZSView create a new one.
  297.  
  298.  
  299.  
  300.                                    - 4 -                         ZSView.DOC
  301.  
  302.  
  303.          There is a Find function for the Index which is activated by
  304.      hitting the "F" key ("F" for  "FIND").  You may look for a single-
  305.